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Y»i<?xml version=" 1 .0" encoding="utf-8"?> 
<VisualStudioToolFile 

Name=" Sample Tool File" 

> 

<Rules> 

<CustomBuildRule 

Name="Sample Rule" 
DisplayName="Sample Rule" 

CommandLine="mytool.exe [SearchPaths] [WamingLevel] 
[IterationCount] [WamingsAsErrors] [SearchString] [Inputs]" 

Outputs="$(InputNaine).bar" 
FileExtensions="*.foo" 

ExecutionDescription="Executing sample rule..." 
SupportsFileBatching="true" 
BatchingSeparator=" " 
ShowOnlyRuleProperties="true" 

> 

<Properties> 

<StringProperty 

Name=" SearchPaths" 
DisplayName="Search Paths" 
Description=="The semi-colon 



delimited list of paths to search. 
msdn.microsoft.com" 



Level 1 is the lowest. Level 4 is the highest," 
msdn.microsoft.com" 



HelpURL="http:// 

Switch="/P [value]" 

Delimited="true" 

Inheritable="true" 

/> 

<EnumProperty 

Name=" WamingLevel" 
DisplayName="Waming Level" 
Properly PageName= " Advanced " 
Description="Sets the warning level. 

HelpURL="http:// 



> 

<Values> 



<Enum Value 

Value="0" 
Switch="AVr 



DisplayName=" Warning Level 1" 



FIG. 3a 
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<EnumValue 



Value="l" 
Switch="AV2" 



Display Name=" Warning Level 2" 



DisplayName=" Warning Level 3" 



/> 

<Enum Value 

Value="2" 
Switch="/W3" 



l> 

<EnumValue 

Value="3" 
Switch="AV4" 



DisplayName="Waming Level 4" 



iterations performed by the tool." 



be treated as errors." 



<yValues> 

</EnumProperty> 

<IntegerProperty 

Name="IterationCoimt" 
DisplayName="Iteration Count" 
Description="Specifies the number of 

HelpURL="http://msdn.microsoft.com" 

Switch="/count:[value]" 

DefaultValue="l" 

/> 

<BooleanProperty 

Name="WamingsAsErrors" 
DispIayName="Wamings As Errors" 
PropertyPageName="Advanced" 
Description="If set to true, warnings will 

HelpURL="http://msdn.microsoft.com" 
Switch="/wamaserror" 



FIG. 3b 
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search for" 
msdn.microsoft.com" 



l> 

</Properties> 
</CustomBuildRule> 

</Rules> 
</VisualStudioToolFile> 



<StringProperty 

Name=" SearchString" 
DisplayName=" Search String" 
Description=" Specifies the string to 

HelpURL="http:// 

S witch="/search: [value] " 
Delimited="true" 



FIG. 3c 
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<?xml version=" 1 .0" encoding="utf-8" ?> 
<xs:schemaxinlns:xs="http://www.w3.org/2001/XMLSchema"> 

<xs:element name="VisualStudioToolFiIe" type="VisualStudioToolFile" /> 
<xs:complexType name="VisualStudioToolFile"> 

<xs:choice minOccurs="0" maxOccurs=" 1 "> 

<xs:element name="Rules" maxOccurs="l" 

minOccurs="0"> 

<xs:complexType> 

<xs:sequence 

maxOccurs=="unbounded" minOccurs="0"> 

<xs:eleinent 

name="CustomBuildRule" type="CustomBuildRule" /> 

</xs:sequence> 
</xs :complexType> 
</xs:element> 
</xs:choice> 

<xs:attribute name="Name" type="xs:string" use="required" /> 
<^xs:complexType> 

<xs:complexType name="CustomBuildRule"> 
<xs:sequence> 

<xs :element name="Properties" maxOccurs=" 1 " 

minOccurs="0"> 

<xs:complexType> 

<xs:choice minOccvirs="0" 

maxOccurs="iinbounded"> 

<xs:element 

naiiie="StringProperty" type="StringPropeity" /> 

<xs:element 

name="EnuniProperty" type="EnumProperty" l> 

<xs:element 

name="BooleanProperty" type="BooleanProperty" l> 

<xs:element 

name="IntegerProperty" type="IntegerProperty" l> 

</xs:choice> 
</xs:complexType> 
</xs:element> 
</xs:sequence> 

<xs:attribute name="Name" type="xs:string" use="required" /> 
<xs:attribute name="DisplayName" type="xs:string" use="optionar' /> 
<xs:attribute name="CominandLine" type="xs:string" use="required" /> 
<xs:attribute name="Outputs" type="xs:string" use="required" /> 
<xs:attribute name="AdditionalDependencies" type="xs:string" 

use="optional" /> 



FIG. 4a 
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<xs:attribute name="FileExtensions" type="xs:string" use=" required" /> 
<xs:attribute name="ExecutionDescription" type="xs:string" use="optional" 
default="Executing tool..." /> 

<xs:attribute name="SupportsFileBatching" type="xs:boolean" 

use="optional" /> 

<xs:attribute name="BatchingSeparator" type="xs:string" use="optionar' 

default^" " i> 

<xs:attribute name="ShowOnlyRuleProperties" type="xs:boolean" 
use="optional" default=="false" l> 
</xs:complexType> 

<xs:complexType name="StringProperty"> 
<xs:complexContent> 

<xs:extension base="Property"> 
<xs: sequence /> 

<xs:attribute name="Switch" type="xs:string" 



use="optional" /> 
use="optional" /> 

use="optional" default="false" /> 
use="optionar' default=";," /> 
use="optional" default="false" /> 



<xs:attribute name="DefaultValue" type="xs:string" 
<xs:attribute name="Delimited" type="xs:boolean" 
<xs:attribute name="Delimiters" type="xs:string" 
<xs:attribute name="Inheritable" type="xs:boolean" 



</xs:extension> 
</xs:complexContent> 
<yxs:complexType> 

<xs:complexType name="EnumProperty"> 
<xs:complexContenP* 

<xs:extension base='Troperty"> 
<xs:sequence> 

<xs:elenient name="Values" 

minOccurs="l" maxOccurs—' 1 "> 

<xs:complexType> 

<xs:sequence 

niaxOccurs="unbounded" ininOccurs="0"> 

<xs:element name="EnumV£ilue" type="EnumValue" /> 

</xs:sequence> 
</xs:complexType> 
</xs:element> 
</xs:sequence> 

<xs:attribute name="DefaultValue" 
type="xs:integer" use="optional" default="0" /> 

</xs:extension> 
</xs : complexContent> 
</xs:complexType> 
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<xs:complexType name="EnuinValue"> 

<xs:sequence /> 

<xs:attribute name=" Switch" type="xs:string" use="optionar' /> 
<xs:attribute name=" Value" type="xs: integer" use="required" /> 
<xs:attribute name="DisplayName" type="xs:string" use=" optional" /> 
</xs:complexType> 

<xs:complexType name="BooleanProperty"> 
<xs:compIexContent> 

<xs:extension base="Property"> 
<xs:sequence /> 

<xs:attribute name="Switch" type="xs:string" 

use="optional" /> 

<xs:attribute name="DefaultValue" 
type="xs:booleaR" use="optional" default="false" /> 

</xs:extension> 
</xs:complexContent> 
<;^xs:complexType> 

<xs:complexType name="IntegerProperty"> 
<xs :complexContent> 

<xs:extension base=" Property "> 
<xs: sequence /> 

<xs:attribute name=" Switch" type="xs:string" 

use="optional" /> 

<xs:attribute name="DefaultValue" 
type="xs:integer" use="optional" default="0" t> 

</xs :extension> 
</xs:complexContent> 
</xs:complexType> 
<xs:complexType name="Property"> 

<xs:sequence></xs:sequence> 

<xs:attribute name="Name" type="xs:string" use="required" /> 
<xs:attribute name="IsReadOiiiy" type="xs:boolean" use="optional" 



default="false" /> 



default="General" f> 



<xs:attribute name="DisplayName" type="xs:string" use=" optional" /> 
<xs:attribute name="Description" type="xs:string" use="optionar' /> 
<xs:attribute name="PropertyPageNanie" type="xs:string" use=" optional" 



<xs:attribute nanie="Category" type="xs:string" use="optionar' t> 
<xs:attribute name="HelpContext" type="xs:integer" use="optional" l> 
<xs:attribute riame="HelpFile" type="xs:string" use="optional" /> 
<xs:attribute name="HelpURL" type="xs: string" use="optional" /> 
</xs:complexType> 
</xs:schema> 
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